1Scan — запуск примеров SDK

В комплекте два файла 1С: OneScanDemo.cf — основа новой учебной базы, OneScan.cfe — SDK и готовые формы примеров с открытым кодом. Все примеры и описания методов изучаются в конфигураторе.

Нужны 1С:Предприятие 8.3.27 или новее, веб-сервер с модулем расширения 1С и приложение 1Scan для Android. Сборка комплекта проверена на платформе 8.3.27.2342.

1. Создайте учебную базу

  1. В списке баз 1С нажмите Добавить → Создание новой информационной базы → Создание информационной базы без конфигурации. Назовите её «1Scan — демо SDK» и выберите новый пустой каталог.
  2. Откройте новую базу в Конфигураторе. Выполните Конфигурация → Открыть конфигурацию, затем Конфигурация → Загрузить конфигурацию из файла и выберите OneScanDemo.cf.
  3. Нажмите F7 и примите изменения конфигурации базы данных.

Файл CF предназначен только для новой учебной базы. Для подключения к существующей базе не загружайте CF: установите расширение по следующему шагу.

2. Установите расширение

  1. В конфигураторе откройте Конфигурация → Расширения конфигурации. Выполните Загрузить конфигурацию из файла и выберите OneScan.cfe. Если сначала требуется создать расширение, добавьте его с именем OneScan, затем загрузите файл в него.
  2. У расширения OneScan снимите флажок Безопасный режим. Примените изменения и перезапустите сеанс 1С.

В своей базе устанавливайте расширение сначала в тестовую копию. Если OneScan уже установлен, откройте его: демо входит в общее расширение, второе расширение с тем же именем не требуется. Для Розницы, УНФ, УТ и Бухгалтерии используйте OneScan.cfe из комплекта своей конфигурации. У общего SDK заимствован язык «Русский»; для собственной конфигурации при необходимости сопоставьте этот язык в конфигураторе.

3. Опубликуйте базу и подключите 1Scan

  1. В конфигураторе выберите Администрирование → Публикация на веб-сервере. Задайте имя, например onescan-sdk, и каталог публикации. Включите Публиковать доступ для клиентских приложений. Для файлов и фото на вкладке HTTP сервисы включите Публиковать HTTP сервисы расширений по умолчанию. Нажмите Опубликовать.
  2. Проверьте открытие публикации в браузере. Веб-сервер должен иметь доступ к каталогу базы, а телефон — к адресу веб-сервера. Для телефона используйте сетевой адрес компьютера, например http://192.168.1.10/onescan-sdk.
  3. В 1Scan добавьте рабочее место Веб-клиент 1С. В подключении укажите адрес сервера и имя публикации. Если в базе созданы пользователи, задайте логин и пароль в подключении 1Scan — они нужны также для передачи файлов.
  4. В настройке При входе открывать выберите Форму по ссылке, затем Подставить демо SDK. Ссылка: e1cib/app/DataProcessor.OneScan_ДемоSDK. Выберите режим Встроенное рабочее место, сохраните и откройте его.
  5. Откройте раздел Сканирование, нажмите Сканировать камерой и считайте штрихкод. Результат появится в форме 1С. Затем проверьте выбор небольшого файла.

В обычном клиенте 1С можно изучать формы. Команды камеры и других возможностей Android выполняются внутри приложения 1Scan. Для пользователя с ограниченными правами нужны роль расширения ОсновнаяРоль, доступ к веб-клиенту и встроенному рабочему месту.

4. Посмотрите код и перенесите пример

  1. В конфигураторе откройте расширение OneScan двойным щелчком. В его дереве выберите Обработки → OneScan_ДемоSDK → Формы и нужную форму, например Сканирование или Файлы.
  2. У кнопки откройте связанную команду и её Действие. В модуле формы рядом находятся вызов SDK и обработчик результата.
  3. Описание метода, параметров и результата находится над методом в Общие модули → OneScan_Клиент → Модуль.
  4. Для первого собственного примера скопируйте нужную форму в свою обработку. Сохраните подключение SDK в ПриОткрытии, сверку ожиданий СверкаSDK и освобождение контекста в ПриЗакрытии. Затем замените вывод результата своей логикой. Общее расширение OneScan оставьте установленным.

Сценарии: сканирование, файлы и фото, сообщения, Broadcast, Activity, HTTP, настройки, сведения об устройстве и другие возможности. Состав доступных функций зависит от устройства и разрешений Android.

SDK на сайте · Установка и права · Поддержка